home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / stre24.zip / STREE24.DOC < prev    next >
Text File  |  1992-03-07  |  12KB  |  232 lines
  1.  
  2.                   █████   ██████ ██████  ███████ ███████
  3.                  ██   ██  █ ██ █  ██  ██  ██   █  ██   █
  4.                  ██         ██    ██  ██  ██ █    ██ █
  5.                   █████     ██    █████   ████    ████
  6.                       ██    ██    ██  ██  ██ █    ██ █
  7.                  ██   ██    ██    ██  ██  ██   █  ██   █
  8.                   █████    ████  ███  ██ ███████ ███████
  9.  
  10.                               Version 2.4
  11.  
  12.                             By Mitchell Ross
  13.  
  14.  
  15. Welcome to the latest and greatest verson of STREE! Well, what's new with 2.4?
  16.  
  17.          - There's now two versions: Shareware and Registered. The Registered
  18.            version has a few more "bells & whistles".
  19.          - Less mememory usage for memory buffered reads.
  20.          - Disk buffered read for monster size drives. (S-L-O-W)
  21.          - Drive mapping/redirection information is shown when selecting
  22.            the drive to read. Users addicted to SUBST and Novell users will
  23.            love this new feature!
  24.          - A primitive, but very usefull file viewer has been added to
  25.            the file view window of the registered version. Just press ENTER
  26.            on the file to view.
  27.          - You can now shell to DOS from the main screen of the resistered
  28.            version. See below for details on how it works, and some tips for
  29.            power users.
  30.          - Better documentation! As time goes by, it WILL get better, but
  31.            this a giant step in the right direction.
  32.          - On a single file delete, a drive re-read is done upon exiting the
  33.            file view window instead of after each delete.
  34.          - The file bar now stays near last delete, just like the directory bar.
  35.          - Monochrome PC's now default to LCD color set.
  36.          - Speed-read is dead. If anybody really used it, let me know.
  37.          - After a KILL, the screen dosen't do a "down scroll", it just
  38.            jumps straight there. That one's been anoying me.
  39.  
  40. ------------------------------------------------------------------------------
  41.                          What's STREE anyway?
  42.  
  43. STREE (say "ESS-tree") is a utility that reports information about your hard
  44. drive's tree structure, and provides a quick and easy way to delete directories
  45. that contain many files and subdirectories. Before you say "Oh no, another 
  46. shell", fire up STREE and see what it can do. STREE was never designed to be a
  47. DOS shell type program, but rather a "what's on this drive anyway?" and a "I
  48. need disk space NOW!" utility. As the Senior Programmer for a consulting firm,
  49. this utility was the result of "there's gotta be a better way."
  50.  
  51. ------------------------------------------------------------------------------
  52.                                Basic Usage
  53.  
  54. Using STREE is easy! If you like to use command line parameters, type STREE /?
  55. for a help list. STREE will run completly interactive otherwise, starting with
  56. the drive to use. Press the letter of the drive to scan, and STREE will read
  57. all the information off your drive that it needs. After it is done reading,
  58. you will enter the directory view mode. On screen is a report that shows the
  59. directory tree along with information about each directory. On-line help is
  60. available by pressing F1 from here, as shown on the top line along with some
  61. of the functions available from this area.
  62.  
  63. Here's a summary of these functions:
  64.  
  65.  View a Directory  - You can view a list of files in any directory by pressing
  66.                      ENTER on the directory you want to see. From this window,
  67.                      you can delete single files, and view the contents of 
  68.                      files by pressing enter on that file.
  69.  
  70.  Print - - - - - - - The report you see on screen can be saved to a disk file
  71.                      or sent to a printer. If your printer cannot support the
  72.                      IBM line draw characters, you have the option of 
  73.                      converting them to "vanilla ASCII" characters.
  74.  
  75.  Kill A Directory- - This is the most powerful, and possibly dangerous, 
  76.                      feature of STREE. If your drive had a tree structure
  77.                      like this:
  78.  
  79.                      ROOT
  80.                      └- UTILS
  81.                         ├─ MACE
  82.                         ├─ NORT
  83.                         │  └─ NC
  84.                         ├─ OTHER
  85.                         └- PUBLIC
  86.  
  87.                      And you KILL'ed the NORT directory, all files in the 
  88.                      directories NORT and NC would be deleted, along with the
  89.                      directory listings themselves. This would leave the drive
  90.                      looking like this:
  91.  
  92.                      ROOT
  93.                      └- UTILS
  94.                         ├─ MACE
  95.                         ├─ OTHER
  96.                         └- PUBLIC
  97.  
  98.  New Drive - - - - - Use this if you want STREE to examine another drive. If
  99.                      you pressed "N" by mistake, the ESC key will back you out
  100.                      without re-reading the current drive.
  101.  
  102.  Find a Directory- - If the current drive is quite large, STREE can find a
  103.                      directory for you with a search. The search is done on
  104.                      the names of directories only, not by file names. (Well,
  105.                      not yet...)
  106.  
  107.  Shell to DOS- - - - Executes a DOS command in the selected directory. Memory
  108.                      is swapped to EMS or a disk file. Great for moving files
  109.                      to an archive, like ZIP's or ARC's.
  110.  
  111. ------------------------------------------------------------------------------
  112.                   Important Information On Shelling To DOS
  113.  
  114. STREE by nature is a memory hog in an attempt to be as fast as possible, BUT
  115. in order to be able to do a DOS shell, we must have some memory free for DOS
  116. to use. The solution? Swap a large portion of used memory out to EMS memory or
  117. a temporary disk file. There's some restrictions on doing this, though.
  118.  
  119.   - To swap to EMS, you'll need around 600k of EMS free.
  120.   - If there's not enough EMS free, you'll need about 600k of disk space free.
  121.   - Durring the DOS shell, the swap file on disk is left open (but hidden).
  122.     It is therefore VERY important NOT to run any programs that change low-level
  123.     information on disk, like CHKDSK or de-fragmenters.
  124.   - As in all DOS shells, loading TSR's is a big no-no. This will almost always
  125.     lead to a system crash upon returning to STREE.
  126.  
  127. If you stay within these rules, you can do just about anything you want in the
  128. shell. If you enter the name of a program that is not in the current directory,
  129. STREE will automatically search the path for you. The main reason for having a
  130. shell in STREE is to free up space by using a data compression program, like
  131. PKZIP, ARC, and the like. Here's a sample shell command I might enter:
  132.  
  133.         PKZIP -M OldGames *.*
  134.  
  135. ------------------------------------------------------------------------------
  136.                       Networks, low RAM, and other topics
  137.  
  138. ---- Networks
  139. STREE is network friendly, and has been tested on Novell Netware, Netware Lite,
  140. Lantastic, and others. In order to get accurate reports, you'll need to have
  141. network rights to at least read the file listings in each directory. If you'll
  142. be deleting anything, you will obviously need to have network rights to delete
  143. those files.
  144.  
  145. ---- When you run out of Memory
  146. When STREE gives you an "Error: Out of Memory" message, there are a few things
  147. you can try:
  148.     - Run STREE straight from the DOS prompt, as opposed to another program's
  149.       "Shell to Dos" function.
  150.     - Release as many TSR's as you can, or load them high with QEMM or a
  151.       similar class program.
  152.     - Add /D to the command line when starting STREE. This will force the read
  153.       buffers to be on disk, using a lot less memory. The major drawback is
  154.       that the time to read a drive will be 2 or 3 times longer.
  155.  
  156. --- How To Increase STREE's Performance
  157. Some common ways to speed things up:
  158.     - A disk cache program, if you're not on a network. If you're not using
  159.       a disk cache already, then by all means go out and buy Super PC-Kwik.
  160.       It's the best one on the market, and is well worth the price. Networks
  161.       often have built-in caching on the server, so adding one to a
  162.       workstation will actually slow network access down.
  163.     - Don't the the /D option unless you have to. Disk buffering is 2 or 3
  164.       times slower than memory buffering.
  165.     - Use the SUBST command to create a logical drive. If you're only going
  166.       to use the directories off of \PUBLIC, then you might set up a drive
  167.       using this command:
  168.                             SUBST Z: \PUBLIC
  169.  
  170. ------------------------------------------------------------------------------
  171.                      Why YOU should register your copy
  172.  
  173. For one thing, you'll be using STREE legally if you decide to use it on a
  174. regular basis. After registering your copy, you will get:
  175.  
  176.       - A registered copy of the latest version by mail. The registered copy
  177.         has more options than the shareware release.
  178.  
  179.       - Free, unlimited support. You'll also have a higher chance of your
  180.         enhancement "wish list" items being used in future releases.
  181.  
  182.       - You'll be entitled to FREE upgrades, just mail me a disk (any size)
  183.         and a stamped mailer. I'll fill the disk up with other programs you
  184.         might enjoy (some by me, some not...)
  185.  
  186.       - Once registered, always registered.
  187.  
  188. Once you register, you will have 2 versions of STREE. The Shareware version
  189. is the one you can copy and give away. The Registered version is for your own
  190. use. Please don't give out this copy to anyone who has not yet sent in the
  191. registration fee.
  192.  
  193. ------------------------------------------------------------------------------
  194.               Update history (since 2.3, when this list began)
  195.  
  196. STREE 2.3 "what's new?" list:
  197.          - This file, for one. It'll get better, don't worry.
  198.          - New and improved help system, with an index page.
  199.          - LCD color set! Now you can see what you're doing. Just add /LCD
  200.            to the command line. See the on-line help for more options.
  201.          - File count for each directory is now given.
  202.          - The LOOK function has been spiced up with a better "feel".
  203.          - That annoying "Save the SpeedRead file?" question is now gone.
  204.            It's been replaced with a smarter auto-detect method. See the
  205.            on-line help for details on how it works.
  206.          - The date and time are now displayed at the top of the report.
  207.          - Total drive size is now displayed next to the space free.
  208.          - You can now KILL single files from the LOOK window.
  209.          - After a directory KILL the pointer bar stays near where it was
  210.            before, instead of jumping back to the top.
  211.  
  212. ------------------------------------------------------------------------------
  213.                               Credits
  214.  
  215. Many people have helped to make STREE what it is today. Special thanks go to:
  216.  
  217.  
  218.  Robert Lane - Beta testing, Bug Reports, Enhancement requests, Moral support.
  219.                "Why can't STREE do ______?"
  220.  
  221.  Dan Ross    - Enhancement requests, Moral support.
  222.                "Put it in Shareware!"
  223.  
  224.  Ronald Lane - Beta testing, Bug Reports, Enhancement requests.
  225.                "Don't delete C:\ !"
  226.  
  227.  Borland Inc - The world's greatest Pascal compiler. Let's all be thankfull
  228.                that we're not stuck with Mircosoft's languages!
  229.  
  230.  Compu$erve  - An easy way to get 250+ downloads in 2 days, and sometimes a
  231.                registed user too. :)
  232.